HD Engraved Wood Weather Widget
Created by Foundforgood89

**Please purchase "HD Engraved Wood" Winterboard theme to get this mod.  Also check out HD Engraved Wood SBS for a great SBSettings theme built to work with this theme**

DESCRIPTION

*Supports iPhone 4.  For pre-retina screen iDevices, look for Engraved Wood Standard Weather Widget*

HD Engraved Wood Weather Widget has an awesome new layout for use with the winterboard theme and high quality weather updates right on your homescreen.  It provides brand new, HD quality weather images in a stylish and sophisticated manner, along with written descriptions of location, weather, and temperature, and a reserved but informative display of the month, day, and date.  Wallpapers templates are provided for creating Dock set ups of 4, 5, or 6 (use Infinidock to increase the number of applications on your dock).  Using Iconoclasm, you can set up a brilliant new Layout that fits stylishly with the wallpapers



INSTRUCTIONS 

**NEW**
Installation videos to help you set up Engraved Wood and all it's components
See the following youtube video links:

Part 1/3: http://www.youtube.com/watch?v=ffxzhmgnn8Q

Part 2/3: http://www.youtube.com/watch?v=SCbS9xnqrGU

Part 3/3: http://www.youtube.com/watch?v=Gl4m0xK7APg

PLEASE WATCH THEME BEFORE EMAILING ME WITH QUESTIONS!  if you have trouble, try reading the steps below or emailing me.



There are some recommended applications/tweaks from cydia...
	---It is HIGHLY recommended to use Folder Enhancer with the Iconoclasm layout as folders will not work properly without it.  Folder Enhancer has it's own custom pages created specificially for the theme. (Cydia: Paid)
	---Iconoclasm is recommended for a new layout that will work best with the custom wallpapers made specifically for the weather widget. (Cydia: Paid)
	---Infinidock is recommended for creating Wallpaper/Dock templates that contain more than 4 icons.  5 Icon Docks or 6 Icon Docks are recommended for this template.  Scrolling Docks using Infinidock will not work with this theme (Cydia: Paid)
	---Rename 2 (a little rare, but there is one in the xSellize repo): This should solve some cases of long Application Names overlapping due to the Iconoclasm Layout.(Cydia: Free)

BUGS:  Most of the following bugs are simply due to the way the widget was constructed, and due to this, they will probably not be fixed as it means I would have to start the whole thing from scratch.  Please be aware of these before emailing bugs.  The following contains some workarounds that may help:
	---Infiniboard: This widget will not work with Infiniboard's vertical scrolling as the page layouts in Iconoclasm are of a different size than Infiniboard will use properly.
	---Font Overlapping:  There has been some cases of Font Overlapping with icons and the interface.  Since there are so many different fonts out there that may not work, I have decided only to support 2: Helvectica and NeoTech.  I have provided two stylesheets (one for each) that should fit those fonts accordingly since they are different sizes.  If there are any cases of these fonts ONLY overlapping with icons during any weather or day,  please contact me and I will be happy to make the nessessary changes (be sure to send me a screenshot of the problemed area).
	---Application name overlapping:  There has been some cases of application name overlapping due to long names.  However, there is always a chance of long application names ruining layouts.  So I recommend the use of Rename 2 (see above) in order to rename long application names.  This should help solve the problem.
	---Using Appstore Applications or Folders in Dock: See "WALLPAPER/DOCK" section.

Please inform me of any other bugs or problems.

WALLPAPER/DOCK:
	-Due to the way the layout and weather widget is constructed, the dock application's icons must be added directly into the wallpaper for this theme.  I have provided in the theme three wallpaper layouts (one for a 4 icon dock, 5 icon dock, and 6 icon dock) that users can use to create custom layouts (users can also email me for requests).  Also available is a few stock icons that can be used and rearranged accordingly.  
	-Because the icons in the dock are made as wallpaper graphics, the actual icons on the dock themselves are blank.  This means that 1) they must be assigned as so in order for the theme to work, and 2) Appstore Applications (because they are masked) and Folders are not recommended for use (though they can be used but wont look as smooth).  There are is a temporary work around for the Appstore Applications on the dock, but it requires manually removing the mask provided and altering all used icon themes by the user.  Because of the individual maintanence per person, this is impractical for me to do myself, so I will simply recommend not using Appstore Appications or Folders on the dock.
	-If users are less knowledgable about setting up the wallpaper, or simply do not own photoshop, I AM HAPPY TO CUSTOM MAKE YOUR A WALLPAPER.  These are the restrictions: 1) it must contain only 4, 5, or 6 icons in the dock, and 2) The dock icons must NOT be applications bought through the AppStore or folders.

Please look at the Installation guide for steps to setting up the Weather and Dock.

INSTALLATION GUIDE
	1) Download and Install "HD Engraved Wood Weather Widget" through Cydia.
	2) Navigate on your iDevice to /var/stash/Themes.xxxxxx/EW Weather@2x.theme/Widgets/Configs/ using iFiles or an SSH client.  In this folder, locate and open in a text editor "Weather-Config.js"
	3) Next to "var locale = "30033"", replace "30033" with the zip-code of the location you wish to retrieve weather updates from (the widget is configured to use Yahoo Weather updates).  Save and close the text file.
	4) (Iconoclasm users only) Next navigate to /var/stash/Themes.xxxxxx/EW Weather@2x.theme/Widgets/Iconoclasm Layout/ and find the file "Two Row Curve.plist".  Copy this file and paste it in the following folder in the iDevice: /Library/Iconoclasm/Layouts/
	5) Navigate to /var/stash/Themes.xxxxxx/EW Weather@2x.theme/Wallpaper and Folder Template/.  Contained in the folder are 3 "Wallpaper Template-#dock.psd" files.  You can design your own Wallpaper/Dock template using these templates and the icons in the "Dock Icons" folder, or your can use one of the two Sample Wallpaper images provided.  	
		a) go to var/stash/themes.xxx/EW Weather@2x.theme/Wallpaper and Folder Template/ and select the wallpaper you wish to use, and rename it to HomeBackground.jpg.  Then replace the var/stash/themes.xxx/EW Weather@2x.theme/HomeBackground.jpg file with the wallpaper you wish to use.
	-OR-
		b) make or ask me for the wallpaper you wish to use. Make sure it is a jpg and has the right dimensions (320x480 for STD, 640x960 for HD), and rename it HomeBackground.jpg.  Then replace the var/stash/themes.xxx/EW Weather@2x.theme/HomeBackground.jpg file with the wallpaper you wish to use.
	4) respring.(CONTACT ME FOR WALLPAPER/DOCK REQUESTS)
	6) Depending on which Icons you have on your dock, those that are must be made blank.  To do this, remember which applications you wish to make blank.  Navigate to   /var/stash/Themes.xxxxxx/EW Weather@2x.theme/Bundles/.  From here, add the bundle folder for the icons you wish to make blank, and create a replacement blank icon in those folders.  By default, the iPod, Mail, Phone, and Safari application are made blank.  In the "disabled" folder are some additional blank icons and bundle folders (Messages, iRealSMS3, and Overboard).  To activate blanks from the deactivate folder, move the bundle folder in the "disable" folder up one so it is instead in the Bundles folder (ex. /Bundles/com.apple.MobileSMS).  To deactivate blanks, simply move the bundle folder into the "disable" folder (ex. /Bundles/disabled/com.apple.MobileSMS) (CONTACT ME FOR DOCK BLANK REQUESTS)
	7) On the iDevice, activate the Iconoclasm layout "Two Row Curve" from the Settings application.
	8) On the iDevice, activate the "EW Weather@2x.theme" theme using Winterboard.  MAKE SURE IT IS A HIGHER PRIORITY THAN THE "HD Engraved Wood@2x.theme" THEME!!
	9) Respring your device.

4.2.1 installation: For those using 4.2.1, the theme has been upgraded as far as it can be from my end.  The biggest issue is that Iconoclasm hasn't yet been updated for 4.2.1 (as of 1/9/11)  hopefully it will be soon.
-To set it up for 4.2.1 on this end: 


Let me know if there is any other 4.2.1 issues that haven't been addressed...

	--If I missed any steps in installation or you believe it is not set up correctly, do not hesitate to contact me and I will be happy to direct your and change the readme installation guide for future users.

CONTACT INFORMATION
Feel free to contact me for Wallpaper requests.

Please contact me by pressing "Developer: Foundforgood89" in cydia, or by emailing me at foundforgood89@yahoo.com


**Also, keep an eye out for "HD Engraved Wood SBS"**